@database WBStartup+.guide @master WBStartup+.guide @$VER: WBStartup+.guide 2.5 (23.10.95) @author "John Hughes" @(c) "1995" @index Index @node "Main" "WBStartup+" @{b}WBStartup+@{ub} October 23, 1995 by: John Hughes johughes@heartland.bradley.edu WBStartup+ 1995 John Hughes. All Rights Reserved.@{ub} @{" Installing/Updating " link "INSTALL" 0} How to install or update WBStartup+. @{" Author " link "AUTHOR" 0} About the author and compiler. @{" PostcardWare " link "CONTRIBUTIONS" 0} This is Postcardware. @{" Features " link "SYNOPSIS" 0} What WBStartup+ does. @{" L:WBStart-Handler " link "WBSTARTHANDLER" 0} L:WBStart-Handler info @{" " link "BUGS" 0} Bugs in WBStartup+. @{" Where Updates " link "AVAILABILITY" 0} Places to get newer versions @{" Catalogs " link "CATALOGS" 0} Information on included catalogs @{" History " link "HISTORY" 0} Previous versions. @{b}How to use:@{ub} @{" WBStartup+ " link "WBSTARTUP" 0} @{" WBStartup+Prefs " link "WBSTARTUPPREFS" 0} @{" Changing execution order " link "EXECUTEORDER" 0} @endnode @node "INSTALL" "Installation Instructions" @{b}INSTALLATION:@{ub} @{fg shine}Double click the "Install" icon to install WBStartup+ for the first time or to upgrade from a previous version.@{fg text} The installation script makes 2 directories, "WBStartup (Enabled)" and "WBStartup (Disabled)". "WBStartup (Enabled)" holds all the programs that you want to run at startup, and the other holds all your disabled startup programs (ie, ones that you don't want to run at startup). Everything in your SYS:WBStartup directory is moved to the "WBStartup (Enabled)" directory. The WBStartup+ program is copied to your SYS:WBStartup directory. The WBStartup+Prefs program is copied to your SYS:Prefs directory. @endnode @node "AUTHOR" "Author & Tech" @{b}About the author and other tid-bits.@{ub} Program: WBStartup+ Version: 2.5 Date: October 23, 1995 Coded by: John Hughes Email: johughes@heartland.bradley.edu WWW: http://rhf.bradley.edu/~jhughes/ Compiled with: SAS/C 6.56 Machine: A4000 68EC030/25 AmigaDOS 3.1 Required: AmigaDOS 2.0 or above The preferences program requires AmigaDos 3.0 or above. @{" postcard " link "CONTRIBUTIONS" 0} Distribution: WBStartup+ is Postcardware. As long as all of the archive stays intact and unmodified, WBStartup+ may be distributed anywhere. I have released: PointerEyes 4.2 - Very configurable eyes that watch your mouse pointer. Any size, and # of colors. aminet:util/wb/PointerEyes4.2.lha WBMakeLink - Menu in WB tools menu which makes links to files and drawers, and makes an icon for them. aminet:util/wb/WBMakeLink.lha Unreleased: A raytracer for Amiga Dos 3.x, but is designed to be portable. @endnode @node "CONTRIBUTIONS" "Contributions" @{b}Postcardware@{ub} WBStartup+ is @{i}Post Cardware@{ui}. If you use WBStartup+, please send me a post card of your country or city. Of course I will take any type of donations. :) @{i}Send to:@{ui} John Hughes 901 Highview Rd. East Peoria, IL 61611 USA @{i}And even if you don't use WBStartup+, or don't like it, please send me EMail telling me why. Thanks. :)@{ui} I receive a very large amount of email from all over the world from WBStartup+ users who have requests, bug reports, etc. But I have received very few postcards compared to email. If you use WBStartup+, please send me a postcard... It is a very cheap way to show your appreciation for the product. Special thanks go out to all the Europeans who have send me postcards. This is because out of all the postcards I have received, I have only one from the USA, which is rediculous considering I live in Illinois, USA! @endnode @node "SYNOPSIS" "Synopsis" @{b}WBStartup+ does the following:@{ub} o Easy to use GUI preferences program for OS3.x. o Lets you choose the order in which the startup programs run. o Lets you enable and disable the running of each program quickly. o Allows you to have access to Workbench while all of your startup programs are being loaded. o Can be disabled at startup by holding left shift key down. o Progress window shows the icon of the program that is being loaded, and a progress bar with userdefine window background. @endnode @node "WBSTARTHANDLER" "WBStart-Handler Info" @{b}WBStartup-Handler@{ub} The WBStart-Handler is a handler written by Stefan Becker. The full archive can be found on Aminet:util/cli/WBStart1_4.lha @endnode @node "BUGS" "Bugs" @{b}Bugs@{ub} Thanks go out to all those who reported bugs to me. There seems to be a problem when you try to delete a group, but no group has been made. My machine does it fine, but ohter people have said they get an alert, please tell me ifyou have any problems with this. I have no MMU, so it is very difficult to locate enforcer hits once they are present. Please keep me informed of any bugs that you find. E-Mail: johughes@heartland.bradley.edu @endnode @node "AVAILABILITY" "Where to get Updates" @{b}Locations to find Updates@{ub} All WBStartup updates are first posted to Aminet at: ftp://ftp.wustl.edu/~aminet/util/boot/WBStartupPlus.lha Versions 1.0 to 2.0 were put in /util/wb, sorry for the change. Updates are also available at my web site: http://rhf.bradley.edu/~jhughes/ @endnode @node "HISTORY" "History" @{b}History@{ub} V1.0 June 26, 1995 First release. Thanks go to David Swasbrook for showing me an example of how to use GTLV_CallBack. V1.1 July 16, 1995 Corrected a "July" to "June" in the docs. I accidentally asked for money in the "About" menu in the prefs program, all I want is a postcard. Added MWB icons for the enabled and disabled directories. Fixed the install script so that no files are deleted, making it much safer. Minor changes in the documentation. Added Title node to Prefs program's listview. You can now change the loading priority of each startup program within the prefs program. Fixed menus so they are the right colors. V1.2 July 17, 1995 Bug Fix: You could change the priority of title nodes. You can now get the WB info requester for any of the programs in the listview gadget of the Prefs program from a pulldown menu. V1.3 July 18, 1995 Now runs programs without icons. Sorry about that :( Bug Fix: Forgot to reply to a message in the Prefs program. Forgot to free up some memory in the Prefs program. V1.4 July 19, 1995 Prefs program now lists programs without icons, and no longer displays subdirectories. V1.5 July 25, 1995 Bug Fix: Font was not being shown if it wasn't already loaded. WBStartup+ Prefs now uses the screen font for it's text. Added DELAY as a tooltype for WBStartup+. WBStartup+ Prefs is completely font adaptive. Bug Fix: It was possible to free gadgets more than once it all of them were not created. V1.6 August 6, 1995 Selected entries in the listview are now shaded differently. Added where to get l:wbstart-handler in the docs. The list can be alphabetized from "Alphabetize list" in the "Edit" menu. Added "ALPHABETIZE" as a tooltype. If the tooltypes exists, then the list of programs will be alphabetized. Now recognizes STARTPRI as the priority tooltype to conform more to OS3.x. STARTUPPRI is still recognized, but obsolete, so if both STARTPRI and STARTUPPRI are present, STARTUPPRI is ignored. Changed the priority integer gadget to a slider gadget. V1.7 August 15, 1995 WBStartup+Prefs window is now resizeable. WBStartup+Prefs window now opens larger, depending on the visible screen size and the number of lines in the listview gadget. Can switch between Alphabetical sorting and Priority sorting via a menu. If the list is sorted by priority, an edited priority will be moved into the correct location in the list. Fixed a couple font adaptive miscalculations. V2.0 August 26, 1995 Programs can now be assigned to groups, making quick changes in the preferences program quicker. Holding the Left Shift key down during boot time, causes WBStartup+ to be disabled. MAJOR BUG FIX: Programs without icons (projects) were not being recognized. Added several Group management menu items. Added Select All, None, Toggle menu items. WBStartup+ will not run any program with the name of "WBStartup+", that way if you have the WBStartup+ program in the enabled directory, it will not run recursively forever. The alphabetic ordering in WBStartup+Prefs is now case insensitive using Locale. Prefs window opening width is smarter. Changed the look of the WBStartup+Prefs icon to look like the standard MWB prefs icons. V2.1 September 24, 1995 Now uses Memory Pooling instead of AllocVec(). Fixed potential bug in a list structure when alphabetizing. Received permission to include L:WBStart-Handler in this archive. Archive has moved to Aminet:util/boot Removed accidental FreePool() when "Delete Group" was done, and there were no groups. Enforcer Hit removed: forgot to initialize glist=NULL before CreateContext(). Did I release V2.0 WBStartup+Prefs with a missing tail parenthesis in two path tooltypes? Sorry. A requester now appears when you quit without saving, and there was a group modification. WBStartup+ now has an optional Progress Indicator when it runs, which can have a user defined background. Changed the name of drawer icon images, so they don't have parenthises in them, that way they can be archived with lzx. They are copyied by the installer script and given their proper default names with parenthises. Included a WBStartup+ version for OS2.x and OS3.x Updated installer script to recognize OS2.x and OS3.x V2.2 September 27, 1995 Removed bug causing possible crash when disabling the PROGRESSWINDOW tooltype. V2.3 October 3, 1995 The WBStartup+Prefs window is now a WB AppWindow, so ou can drop icons into it and a requester appears asking you if you want to copy or move the files to the enabled or disabled directory. Was allocating pathname size, and deallocating filename size. Possible program crash removed due to another forgotten glist=NULL. Add "..." to some menu items. V2.4 October 4, 1995 Was allocating one byte less than needed for groupnames when creating them from the menu. When resizing the window, the gadgets are remade, but glist was not initialized to NULL again. WBStartup+ now sets the stack size for each loaded program, although WBStart-Handler seems to not always use the exacts stack size specified. Was allocating sizeof(struct Node) instead of sizeof(struct WBStartupNode) in the OS2.x version of WBStartup+. V2.5 October 23, 1995 Now supports Localization. Included catalogs: Deutsch, Fran ais, Italiano, Norsk, Svenska. Holding the Ctrl key down when WBStartup+ is run will cause WBStartup+Prefs to be run before any programs are loaded, allowing you to choose which programs get loaded. Holding the left Alt key when WBStartup+ is run causes the user to be asked which of the enabled programs should be run. Added PREFSPATH tooltype to WBStartup+ icon. This is the location of the preferences file. Program names are shown in WBStartup+'s progress window. If the case of the letters in the filename and icon name varied, the same program name would be recognized as two different programs. This is now fixed. Added Cancel and Ok gadgets to the Copy File window. The OS3.x version of WBStartup+ was getting it's bottom border of the prefs window overwritten by the background pattern under the right icon image, if the user was using sysihack. WBStartup+ now recognizes the WAIT= tooltype as the # of seconds to wait before loading the next program. WBStartup+ now recognizes the TOOLPRI= tooltype as the priority that the program should have when running. The DELAY= tooltype is now obsolete, therefore it has been removed. WBStartup+ now knows if it has already been run, and if it is run more than once, the user will see a requester asking if it is ok to run it again. The STARTUPPRI tooltype is no longer recognized, please use STARTPRI instead. When the WBStartup+Prefs window is opened on a virtual screen, it is centered vertically in the visible section, and is 100 pixels to the right of the leftmost visible section. The Amiga Workbench x.x text is now properly centered in WBStartup+'s progress window. The busy pointer is now shown when a secondary window is opened, such as the Priority Window. Sizing the main window is now impossible when a secondary window is opened since IDCMP is cut off. Priority Window is now activated when opened. You may use the keyboard up and down arrow keys to change the selected element in the listview gadget. V2.6 October x, 1995 When no program is highlighted in WBStartup+Prefs, and the menu item "Icon Window" is selected, a requester appears telling the user to select a program first. @endnode @node "WBSTARTUP" "How to use WBStartup+" @{b}How to use WBStartup+@{ub} @{b}@{u}Tooltypes@{ub}@{uu} @{" ENABLEDPATH " link "ENABLEDPATH" 0} @{" DISABLEDPATH " link "DISABLEDPATH" 0} @{" PROGRESSWINDOW " link "PROGRESSWINDOW" 0} @{" BACKGROUNDPIC " link "BACKGROUNDPIC" 0} (for OS3.x only) @{" PREFSPATH " link "PREFSPATH" 0} @{" Startup Programs " link "STARTUPTOOLTYPES" 0} @{b}@{u}HotKeys@{ub}@{uu} @{b}Ctrl@{ub} Bringing up WBStartup+Prefs before running any programs. @{b}Left-Alt@{ub} Asks user which of the enabled programs should be run. @{b}Left-Shift@{ub} Disabling WBStartup+, no programs will be run. @{" Changing execution order " link "EXECUTEORDER" 0} @endnode @node "WBSTARTUPPREFS" "How to use WBStartup+Prefs" @{b}How to use WBStartup+Prefs@{ub} The Prefs program allows you to choose which program to run at startup, and in which order to run them. @{b}@{u}Tooltypes@{ub}@{uu} @{" ENABLEDPATH " link "ENABLEDPATH" 0} Must be the same as that of @{" WBStartup+ " link "WBSTARTUP" 0} @{" DISABLEDPATH " link "DISABLEDPATH" 0} Must be the same as that of @{" WBStartup+ " link "WBSTARTUP" 0} @{" ALPHABETIZE " link "ALPHABETIZE" 0} @{b}@{u}App Window@{ub}@{uu} You can easily copy or move files into the enabled or disabled directory by simply dropping icons into the window from workbench. A window will appear asking you if you want to copy or move the files, and whether to put the files in the Enabled or Disabled directory. @{b}@{u}The Listview Gadget@{ub}@{uu} Each item in the list that has a checkmark will be run at startup. To toggle the checkmark, just click the left mouse button on the checkbox. To change the startup priority of a program, click in that area of the listview, set the slider gadget to the desired priority and close the window. To bring up the Workbench icon information window for one of the programs listed in the listview gadget, select the program name, and then select "Icon Window" from the "Edit" pulldown menu. @{b}@{u}Creating Groups@{ub}@{uu} Set the checkmarks in the listview to your desired settings. Choose "Create Group" from the "Edit" menu. Type the name that you want to call the group and press enter. You now have a new group. @{i}You MUST save the settings, or the new group will be forgotten.@{ui} @{i}A requester will be appear to allow you to save any group modifications on quiting.@{ui} @{b}@{u}Selecting a Group@{ub}@{uu} Choose "Group" from the "Select" menu. Select the name of the group you want to use from the list and select "Ok". (Double clicking works too) @{b}@{u}Other Gadgets@{ub}@{uu} Select "Save" to save the settings. Select "Cancel" to exit the program without making any changes. Select the "Restore" menu to restore the setting to what they were when WBStartup+Prefs was run. @endnode @node "EXECUTEORDER" "Changing execution order" @{b}How to change the order in which the startup programs are run.@{ub} Use the @{" WBStartup+Prefs " link "WBSTARTUPPREFS" 0} program. You may add the tooltype @{" STARTPRI " link "STARTPRI" 0} to any of the startup programs icons. @endnode @node "TOOLTYPES" "Tooltypes" @{b}Tooltypes@{ub} Choose the program: @{" WBStartup+ " link "WBSTARTUP" 0} @{" WBStartup+Prefs " link "WBSTARTUPPREFS" 0} @{" Startup Programs " link "STARTUPTOOLTYPES" 0} @endnode @node "ENABLEDPATH" "Tooltype: ENABLEDPATH" @{b}ENABLEDPATH=@{ub} Set ENABLEDPATH to the directory where the programs are that you want to run at startup (boot time). Default: ENABLEDPATH=SYS:WBStartup/WBStartup (Enabled) @endnode @node "DISABLEDPATH" "Tooltype: DISABLEDPATH" @{b}DISABLEDPATH=@{ub} Set DISABLEDPATH to the directory where programs that should not be run at startup are. This is like a storage directory. Default: DISABLEDPATH=SYS:WBStartup/WBStartup (Disabled) @endnode @node "PROGRESSWINDOW" "Tooltype: PROGRESSWINDOW @{b}PROGRESSWINDOW@{ub} This allows you to disable the progress window. This tooltype has NO values, it either exists or it doesn't. To disable the progress window, simple place parenthesis around the tooltype name. Examples: PROGRESSWINDOW The progress window will be shown (PROGRESSWINDOW) No progress window will be shown Default: PROGRESSWINDOW @endnode @node "BACKGROUNDPIC" "Tooltype: BACKGROUNDPIC" @{b}BACKGROUNDPIC=@{ub} @{i}For OS3.x only.@{ui} This allows you to choose what the progress window's background picture. The datatypes.library is used, so you may use any picture format for which you have the corresponding datatype, ie. jpeg, gif, ilbm, tiff, targa, pict, pcx, bmp, etc. Although since some datatypes are slow, I recommend using ilbm pictures. Values: NONE No picture is used. SCREEN The default Workbench Screen picture is used. WINDOWS The default Workbench Window/Drawer picture is used. WORKBENCH The default Workbench Root (non-backdrop) picture is used. @{i}filename@{ui} Type the pathname and filename of any picture you want. Default: BACKGROUNDPIC=WINDOWS Example: BACKGROUNDPIC=sys:pictures/favoritepic.iff @endnode @node "PREFSPATH" "Tooltype: PREFSPATH" @{b}PREFSPATH=@{ub} Set PREFSPATH to the path of the preferences program. Default: PREFSPATH=SYS:Prefs/WBStartup+Prefs @endnode @node "ALPHABETIZE" "Tooltype: ALPHABETIZE" @{b}ALPHABETIZE@{ub} If this tooltype exists, the list of programs will be in alphabetical order, otherwise it will be in order by priority. Examples: ALPHABETIZE The list will be alphabetized from A to Z. (ALPHABETIZE) The list will be ordered by priority. @endnode @node "STARTUPTOOLTYPES" "Startup Programs" @{b}@{u}Tooltypes that WBStartup+ looks at@{ub}@{uu} @{" STARTPRI " link "STARTPRI" 0} @{" " link "WAIT" 0} @{" TOOLPRI " link "TOOLPRI" 0} @endnode @node "STARTPRI" "Tooltype: STARTPRI" @{b}STARTPRI=@{ub} This is the startup priority for each program. The program with the highest priority will be loaded and run first. The values can be 127 to -128, where 127 has the highest priority and would be run first. Programs without this tooltype are considered to have a priority of 0. Example: STARTPRI=100 For instance, I gave MagicCopper : STARTPRI=127 since I want that ugly plain looking screen to go away as soon as possible. And I gave ToolManager : STARTPRI=120 so it will load second, and I will have access to all my hotkeys quicker. @endnode @node "WAIT" "Tooltype: WAIT" @{b}WAIT=@{ub} If a program's icon has this tooltype, there will a delay of xxx seconds after that program is run (before then next program in loaded and run). Example: WAIT=3 So after thae program with this tooltype is run, there will be a 3 seconds delay before the next program is loaded and run. @endnode @node "TOOLPRI" "Tooltype: TOOLPRI" @{b}TOOLPRI=@{ub} This is the priority that the program is to have after it is loaded. Programs with high priorities get use of the CPU more than programs with low priorites. A priority of 0 is default. The maximum priority is 127. The minimum priority is -128. Most priorities are in the range -5 to 5. Usually this should just be 0, or not set. @endnode @node "CATALOGS" "Catalogs" @{b}Catalogs@{ub} The following is a list of catalogs and their authors. @{u}Language@{uu} @{u}Author@{uu} Deutsch Arno Eigenwillig with assistance from Hubert Feyrer Fran ais Eric Sauvageau Italiano Giacomo Magnini Norsk Stian S. Olsen Svenska dast@sth.frontec.se The current .ct file is included in the locale directory. If you would like to see WBStartup+ in your language, please add your translations to that file and email it to me :) @endnode @node Index "Index" Documents @{"Author & Tech" link "AUTHOR"} @{"Bugs" link "BUGS"} @{"Catalogs" link "CATALOGS"} @{"Changing execution order" link "EXECUTEORDER"} @{"Contributions" link "CONTRIBUTIONS"} @{"History" link "HISTORY"} @{"How to use WBStartup+" link "WBSTARTUP"} @{"How to use WBStartup+Prefs" link "WBSTARTUPPREFS"} @{"Installation Instructions" link "INSTALL"} @{"Startup Programs" link "STARTUPTOOLTYPES"} @{"Synopsis" link "SYNOPSIS"} @{"Tooltype: ENABLEDPATH" link "ENABLEDPATH"} @{"Tooltype: BACKGROUNDPIC" link "BACKGROUNDPIC"} @{"Tooltype: ALPHABETIZE" link "ALPHABETIZE"} @{"Tooltype: DISABLEDPATH" link "DISABLEDPATH"} @{"Tooltype: PREFSPATH" link "PREFSPATH"} @{"Tooltype: PROGRESSWINDOW " link "PROGRESSWINDOW"} @{"Tooltype: STARTPRI" link "STARTPRI"} @{"Tooltype: TOOLPRI" link "TOOLPRI"} @{"Tooltype: WAIT" link "WAIT"} @{"Tooltypes" link "TOOLTYPES"} @{"WBStart-Handler Info" link "WBSTARTHANDLER"} @{"WBStartup+" link "Main"} @{"Where to get Updates" link "AVAILABILITY"} Buttons ALPHABETIZE " link "ALPHABETIZE" 0} Author " link "AUTHOR" 0} BACKGROUNDPIC " link "BACKGROUNDPIC" 0} " link "BUGS" 0} Catalogs " link "CATALOGS" 0} Changing execution order " link "EXECUTEORDER" 0} DISABLEDPATH " link "DISABLEDPATH" 0} ENABLEDPATH " link "ENABLEDPATH" 0} Features " link "SYNOPSIS" 0} History " link "HISTORY" 0} Installing/Updating " link "INSTALL" 0} L:WBStart-Handler " link "WBSTARTHANDLER" 0} PostcardWare " link "CONTRIBUTIONS" 0} PREFSPATH " link "PREFSPATH" 0} PROGRESSWINDOW " link "PROGRESSWINDOW" 0} postcard " link "CONTRIBUTIONS" 0} STARTPRI " link "STARTPRI" 0} Startup Programs " link "STARTUPTOOLTYPES" 0} TOOLPRI " link "TOOLPRI" 0} " link "WAIT" 0} WBStartup+ " link "WBSTARTUP" 0} WBStartup+ " link "WBSTARTUP" 0} WBStartup+ " link "WBSTARTUP" 0} WBStartup+Prefs " link "WBSTARTUPPREFS" 0} WBStartup+Prefs " link "WBSTARTUPPREFS" 0} WBStartup+Prefs " link "WBSTARTUPPREFS" 0} Where Updates " link "AVAILABILITY" 0} @endnode